Skip to main content

Drives

Prerequisites
  • Access Level: Admin, Super-admin.
  • Permission Requirements:
  • . Basic Project Interaction
    • View projects they are a member of
    • Classify resources with projects they are active in
  • . Project Management
    • Declassify resources tagged with projects they manage
  • . Basic VM Interaction
    • View drives (inconsistent, see notes)
    • Create drives
    • Edit drives (name and whether to disable backup)
    • View drive keys (necessary to share/attach)
    • Share drives
    • Unshare drives
    • Attach drives to VMs
    • Detach drives from VMs
    • Delete drives they own
    • View hardware/image setups made available to them
    • View own VM configs and configs shared with them
    • Create (and edit) VM configs
    • View own VM username
    • View anyone's VM username (necessary for sharing VMs)
    • View own VMs and VMs shared with them
    • Share VMs with other users
  • . VM Administration
    • Delete arbitrary drives
    • View all VM configs in the system
    • Arbitrarily edit any VM config
    • Arbitrarily delete any VM config
    • Modify any user's VM username
  • . Miscellaneous
    • Transfer ownership of own files and drives

Access the Drives from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.

View All Drives Charts in the Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Scroll down under Charts subsection at the bottom.
  5. View drive types, formats, states, teams, projects and sizes charts as necessary.

View Details About a Drive in Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive to view basic information.
  5. Click the View button in the top right panel.
  6. In the left panel, view the drive name, project, team, format, mounting options, capacity, attachment, owner, backup, creation date, ID, shared users and VMs.

Create a New Drive​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Click the Create new drive button in the top panel.
  5. In the pop-up, enter the drive name, capacity, format, drive owner, team, optional project, optional drive owner, team, project, realm and type.
  6. Click Create.

Create a Project-Tagged Drive​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Click the Create new drive button in the top panel.
  5. In the pop-up, enter the drive name, format, and team.
  6. Select the project to tag the drive, optional drive owner, realm, capacity and type.
  7. Click Create.
info

When creating a new drive for a project-tagged VM, the project tagging the VM is locked to the drive to ensure compatibility with the VM.

Import an External Drive from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Click the Import external drive button in the top panel.
  5. In the pop-up, click the Load file or paste the manifest file produced by ticrypt-driveimport.
  6. Find the file in your local machine.
  7. Click Open to load the file.
  8. View drive name, OS, path, format, capacity, owner, realm and team.
  9. Click Import.

Create an External Drive from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Click the Create external drive button in the top right panel.
  5. In the pop-up, enter the external drive user, name, capacity, realm, team, and optional project.
  6. Click Cut-and-paste config to copy the external drive configuration to the clipboard or click Download config to download the external drive configuration locally.
info
  • External drives are not displayed in the drive list. Their creation action is in the logs.
  • The role of Cut-and-paste config command is to maintain a clean clipboard.

Share a Drive with Other User(s) from Management​

bulk-action

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive to share.
  5. Click the Share button in the top right panel.
  6. In the prompt, click the Share with a user button on the right.
  7. Enter and select the user name(s) by name or email to share the drive with.
  8. Once selected, click Share.
  9. Click Close to exit the prompt.
info

Drives may be shared once they are formatted and attached to a virtual machine upon creation.

caution
  • You must own the drive to share it with other users.
  • As the drive owner, you can share a drive either as read-only or with full access (read-write).

Give Full Drive Access to a User from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive to give full access.
  5. Click the Share button in the top right panel.
  6. In the prompt, filter the shared user by name or email.
  7. Next, select Full-access for the shared user under the Mode column.
  8. Once done, click Close.
danger

Giving full drive access means the user can do anything with the data on the drive.

Give Read-Only Drive Access to a User from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive to give read-only access.
  5. Click the Share button in the top right panel.
  6. In the prompt, filter the shared user by name or email.
  7. Next, select Read-Only for the shared user under the Mode column.
  8. Once done, click Close.

Remove Drive Access from a User from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive to remove user access.
  5. Click the Share button in the top right panel.
  6. In the prompt, filter the users by name or email.
  7. Click the Delete button by the user you want to remove drive access.
  8. Once done, click Close.
note

You can remove multiple users' access from a drive using the same setup.

Edit a Drive’s Name or Team in Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive whose name or team you want to edit.
  5. Click the Edit button in the top right panel.
  6. In the pop-up, under Name subsection, enter the new drive name.
  7. Alternatively, under Team subsection, enter the new team name.
  8. Click Update.

Set Up a Drive for Applications and Databases Storage from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive to set up applications and databases storage.
  5. Click the Edit button in the top right panel.
  6. In the pop-up, click Advanced Options.
  7. Under the No permission management subsection, select Enable.
  8. Click Update.

Set Up a Cache Strategy for a Drive from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive for which you want to set up a cache strategy.
  5. Click the Edit button in the top right panel.
  6. In the pop-up, click Advanced Options.
  7. In the Cache strategy subsection, select default, none, writethrough, writeback or directsync as necessary.
  8. Click Update.

Set Up an IO Strategy for a Drive from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive to set up IO strategy.
  5. Click the Edit button in the top right panel.
  6. In the pop-up, click Advanced Options.
  7. In the IO strategy subsection, select default, threads, or native as necessary.
  8. Click Update.

Change Project in a Drive from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive whose project you want to change.
  5. Click the Change project button in the top right panel.
  6. In the pop-up, select the project to tag the drive.
  7. Click Classify.

Forcefully Change Project in a Drive from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive whose project you want to change.
  5. Click the Change project button in the top right panel.
  6. In the pop-up, tick Use my permission to override rules, re-tag resources with any visible project, regardless of current project relations.
  7. Select the project to tag the drive.
  8. Click Force change with admin privilege.
note

Only users with admin or super-admin roles can perform this action.

Remove Project from a Drive in Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the tagged drive from which you want to remove the project.
  5. Click the Change project button in the top right panel.
  6. In the pop-up, select No project (unlocked) to remove project from drive.
  7. Click Declassify.
note

A declassified project unlocks the drive for all shared users, irrespective of their project membership.

Migrate Drive to a Different Libvirt Storage Pool from Management​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive to migrate.
  5. Click the Migrate Drive button in the top right panel.
  6. In the pop-up, select the new storage pool for migration.
  7. View the drive format, capacity, creation date, team, project, owner, and state.
  8. Click Migrate.

Bulk Email All Drive Users from Management​

bulk-action

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive(s) for which you want to send a bulk email to users.
  5. In the left panel, click the Open Full Menu button in the top right panel.
  6. Select Bulk Email.
  7. In the pop-up, click Copy to copy the emails or click Download to download the emails.
  8. Once done, click Close.
note

Tick the Prefer contact email? to use the email registered upon user account creation.

Transfer Ownership of a Drive to a Different User from Management​

bulk-action

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive(s) whose ownership you want to transfer.
  5. In the left panel, click the Open Full Menu button in the top right panel.
  6. Select Transfer Ownership.
  7. In the pop-up, select the user to transfer ownership to.
  8. View drive format, capacity, creation date, team, project, owner and state.
  9. Click Transfer Ownership.

Unshare the Drive from Everyone Else from Management​

bulk-action

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive(s) you want to unshare from everyone else.
  5. In the left panel, click the Open Full Menu button in the top right panel.
  6. Select Unshare from everyone else.

Delete a Drive from Management​

bulk-action

Method one​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the Drives in the left panel.
  4. Select the drive(s) to delete.
  5. Click the Open Full Menu button in the top center panel.
  6. Click Delete.
  7. In the prompt, tick the drive name(s) and type "Confirm" in the field bellow.
  8. Click Delete Drive(s).

Method two​

  1. Go to the Management icon in the top left taskbar.
  2. Navigate to the Virtual Machines section.
  3. Click the VM Configurations in the left panel.
  4. Select the Stopped VM Configuration to delete its drive(s).
  5. Click the Open Full Menu button in the top center panel.
  6. Select Delete.
  7. In the prompt, tick the drive name(s) and type "Confirm" in the field bellow.
  8. Click Delete Drive(s).
danger
  • You have to shut down the VM to delete its drive, then you need to unattach the drive.
  • You cannot delete a drive that is attached (in use).
  • Deleting a drive is a permanent action, and all data on the drive will be lost.
  • Bulk deleting drives is a dangerous action for the system. Only super-admins should perform this action in very rare scenarios.